Skip to main content

Print error codes (printError)

CodeNameMeaning
0OKSuccess
1AUTH_ERRORSignature/auth error
2INVALID_JSONJSON/Base64 parse error
3MISSING_PARAMSRequired fields missing
4AMOUNT_MISMATCHAmount mismatch
5INTERNAL_ERRORInternal/not implemented
6SHIFT_NOT_OPENShift is not open
7PAYMENT_TYPE_NOT_SUPPORTEDUnsupported payment type
8DOCUMENT_NOT_PAIDDocument not fully paid
9DOCUMENT_NOT_FOUNDDocument not found
10DOCUMENT_NOT_FISCALIZEDDocument not fiscalized
11CHANGE_ONLY_FOR_CASHChange allowed only for cash
12DOC_TIME_BEFORE_SHIFTDocument time before shift open
13CREDIT_SINGLE_PAYMENTCredit payment constraint violated
14INVALID_DATE_FORMATInvalid date format
15DOCUMENT_NOT_PRINTEDDocument not printed
23BANK_TERMINAL_NOT_CONNECTEDBank terminal not connected
44DOCUMENT_STILL_PROCESSINGDocument processing in progress

printError is a separate code space from code. It always accompanies a print-stage failure, but the accompanying code is not always 15:

  • /sale, /refund, /close_shift, /deposit, /withdraw — print failures use code = 15 (DOCUMENT_NOT_PRINTED).
  • /x_report, /dates_report, /check_copy — print failures currently surface as code = -1 or no code, not 15 (known inconsistency in the current server; the same underlying print-error condition, just not normalized to DOCUMENT_NOT_PRINTED on these routes).

Because of this, check for a non-null printError regardless of what code is, rather than gating print-error handling on code = 15 alone.

printErrorMeaning
1Overheat
2No paper
3Overflow
4Printer state error
5Other printer error
6Low battery
7No connection